table of contents
AUDIT_SET_FAILURE(3) | Linux Audit API | AUDIT_SET_FAILURE(3) |
NAME¶
audit_set_failure - Set audit failure flag
SYNOPSIS¶
#include <libaudit.h>
int audit_set_failure(int fd, uint32_t failure);
DESCRIPTION¶
audit_set_failure sets the action that the kernel will perform when the backlog limit is reached or when it encounters an error and cannot proceed. Possible values are:
- 0 - AUDIT_FAIL_SILENT
- Do nothing, report nothing, skip logging the record and continue.
- 1 - AUDIT_FAIL_PRINTK [default]
- Log the audit record using printk which will cause subsequent events to get written to syslog.
- 2 - AUDIT_FAIL_PANIC
- Call the panic function. This would be used to prevent use of the machine upon loss of audit events.
RETURN VALUE¶
The return value is <= 0 on error, otherwise it is the netlink sequence id number. This function can have any error that sendto would encounter.
SEE ALSO¶
audit_set_backlog_limit(3), audit_open(3), auditd(8), auditctl(8).
AUTHOR¶
Steve Grubb
June 2015 | Red Hat |